This file lists the program codes for the new built in Random Happening
Program (RHP) system.  See LORDCAVE.DOC under the section [EXTRA SETUP
INFO] for how to install your RHPs into The LORD Cavern.  For a list of
LORD codes to use in player's mail, see the file LORDSTRC.PAS that came
with LORD.  Remember that if you distribute your programs, please give
me credit for writing The LORD Cavern!
                                        
Look at PROGRAM.SMP to see how these can be used.

The RHP language uses codes that have a @ on both sides, that must be
capitalized and that must be the first and only thing on a line (unless it
needs parameters).

This first set is just normal commands with no parameters.

@;@      Comment, everyting on a line with this at the front will be ignored
@CLEAR@  Clear the screen
@MORE@   Pause for keypress with "<MoRE>"
@DELAY@  Small delay (250 milliseconds)
@END@    Stop program and pause

This set is for writing to a player's MAIL?.DAT and LORD's LOGNOW.TXT.

@MAIL@      Start writing to mail
@MAILEND@   Stop writing to mail
@NEWS@      Start writing to LOGNOW.TXT
@NEWSLINE@  Stop writing to LOGNOW.TXT and add a line "-=-=-=-" centered
@NEWSEND@   Stop writing to LOGNOW.TXT

The following two sets can be used in mail and news recordings.

The next set is for designating setions to go to.

@#xxxxxxxx         Section designation, 8 character max
@GOTO@ @#xxxxxxxx  Go to section xxxxxxx after this command

The one in this section is for making lengths of strings.

@SPACE@ x  Add x spaces to string

The following set is for prompting for input.  The single character
section is used to act on input.  The program runner acts on the first
matching section found, so don't use the same selections nested.
Example: @PROMPT@ CD (prompts for C and D selections, must be an @##C and
                      @##D sections later.)

@YESNO@        Prompt for Y/n, Y and N sections
@PROMPT@ xx..  Prompt for selections xx.., selections must be capitalized
               The first selection will be the default one
@RANDOM@ x     Random number between 1 and x, each number a section
@##x           Single character section

The following set has some special properties.  If you put a = before the
number x, it makes that attribute equal to x.  If you put %, it adds /
subtracts x% of the existing attribute to the attribute.
Example: @EXPERIENCE@ %-15 (Subtracts 15% of experience)
Example: @GOLD@ =0 (Sets gold in hand to 0)

@SEARCH@ x      LORD Cavern seraches
@FOREST@ x      Forest fights
@FIGHTS@ x      Player fights
@KIDS@ x        Kids
@DEFENCE@ x     Defence
@STRENGTH@ x    Strength
@EXPERIENCE@ x  Experience
@LAYS@ x        Lays
@SKILL@ x       Current Skill type (if resulting number is above 40 the
                Skill value is set to 40, no uses are given)
@HITPOINTS@ x   Current HitPoints
@HITMAX@ x      Max HitPoints
@GEMS@ x         Gems
@GOLD@ x        Gold in Hand
@BANK@ x        Gold in Bank
@CHARM@ x       Charm

The following codes can be put anywhere in a line, even in mail and news
recording.  They are case sensitive!

`n  Put player's name
`a  Put player's armour name
`w  Put player's weapon name
`l  Do not linefeed (put at the end of a line)
`s  Put player's sex (he/she)
`o  Put player's opposite sex (he/she)
`[  Put player's sex possesive (his/her)
`]  Put player's opposite sex possesive (his/her)